home *** CD-ROM | disk | FTP | other *** search
/ Mac Format 1996 April / MacFormat CD Edition MF36 (April 1996).iso / Floppy / MacFormat Floppy Archive / MacFormat 23 / eXpress Folder / eXpress v1.0.0 Documentation < prev    next >
Text File  |  1994-09-04  |  8KB  |  131 lines

  1.                         *** eXpress v1.0.0 ***
  2.  
  3.                       Released September of 1994
  4.  
  5.                        -Official Documentation- 
  6.  
  7.  
  8.    REDISTRIBUTION OF ANY VERSION OF eXpress IS STRICTLY FORBIDDEN                 
  9.      WITHOUT THE DOCUMENTATION FILE FOR THE RESPECTIVE VERSION.
  10.  
  11. (This file looks best if viewed in 9 point Monaco or some alternative mono-spaced font)
  12.  
  13. *********************************************************************
  14. The eXpress source code, compiled code, and documentation are all Copyright © 1994 By Stephen Maas. All rights are reserved except those specifically forfeited in this document
  15. *********************************************************************
  16.  
  17.  
  18. File Contents
  19. =============
  20.  
  21.      I.    What Does eXpress Do?
  22.      II.   Using eXpress
  23.      III.  Legal Stuff
  24.      IV.   Scholarware
  25.      V.    Contacting the Author
  26.      VI.   Acknowledgements
  27.      VII.  About the Author
  28.      VIII. Program Code Overview
  29.  
  30.  
  31. What Does eXpress Do?
  32. =====================
  33.  
  34.      eXpress is an application that installs some code which allows you to access the Process menu (the one on the far right side of the menu bar in System 7.x) from anywhere on the screen. After using System 7 for a while, I got sick and tired of running the cursor to the menu bar to change to a process that didn't have a visible window to click in. Because of this, I wrote eXpress. If you want to know the nitty gritty of eXpress, see the Program Code Overview at the end of this file. 
  35.  
  36.  
  37. Using eXpress
  38. =============
  39.  
  40.      Using eXpress is very simple. You launch the application and click to dismiss the splash screen. That's all there is to it. eXpress installs some code, much like an INIT does, and then quits.
  41.  
  42.      Once installed, eXpress allows you to access the Process menu (the one on the far right side of the menu bar) from anywhere on the screen. Simply hold down the control key and click the mouse button. The Processes menu will pop up right at the cursor.
  43.  
  44.      eXpress needs to be run each time you start your Mac in order for it to do its magic. I suggest throwing it in your Startup Items folder. Then you will always be able to take advantage of eXpress.
  45.  
  46.      eXpress is very memory friendly, taking only about 200 bytes of memory once it is installed so don't worry about it taking over all your RAM. eXpress gives you a lot of bang for your byte.
  47.  
  48.  
  49. Legal Stuff
  50. ===========
  51.  
  52.      I, the author, assume no responsibility for any harm you may cause to your hardware or software by using the program eXpress. eXpress carries no warranties, expressed, written, or implied. You use this software at your own risk. If you screw over your machine with it too bad for you. The author assumes no liability for any damage caused by eXpress. YOU HAVE BEEN WARNED.
  53.  
  54.      You are free to distribute eXpress for non-commercial use provided it is distributed WITH the respective documentation file. You MAY NOT CHARGE for any redistribution, be you an individual or business (this INCLUDES Sheerer houses that charge on a per disk basis). If eXpress is distributed via an online service (e.g. Compu$erve), it MUST be made available as a "free download." If you had to pay to get your copy of eXpress, please contact the author immediately.
  55.  
  56.      eXpress is Scholarware. If you use eXpress on any computer, or store it with the intent to use it at a later date, you are required to fulfill your obligation as it is laid out in the following section of this document. eXpress becomes Freeware in June of 1996. On the 1st of June, 1996, all Scholarware obligations are rescinded. DISTRIBUTION RESTRICTIONS REMAIN IN EFFECT.
  57.      
  58.  
  59. Scholarware
  60. ===========
  61.  
  62.      Scholarware is a new type of software distribution system that I am pioneering. I am going off to college in the fall of 1996 and would like to apply for a few scholarships between now and then. Therefore, if you use this software, you are obligated to send me information on AT LEAST one scholarship available for incoming college freshmen. 
  63.  
  64.      If you can't do this, you are obligated to contribute to my college fund (as much as you want). I would prefer scholarships that are school independent, but I won't turn down any information you send. College isn't cheap, help me make it through.
  65.  
  66.      As far as scholarship qualifications go, I am not a minority or a woman, so those scholarships are out. I am qualified (GPA of 3.9 out of a possible 4.0) for academic scholarships and am highly involved in school activities.
  67.  
  68.  
  69. Contacting the Author
  70. =====================
  71.  
  72.      I can be reached by the following methods.
  73.  
  74.      Internet E-mail: mrmacman@pro-algonquin.mn.org
  75.                                    or
  76.                              do485@cwru.edu
  77.  
  78.      Phone: (612) 450-1652  - Voice line
  79.             (612) 457-5478  - Data line and answering machine
  80.  
  81.      IRC: Look for me as Anonymous, Macman, or Stephen on #macintosh,                
  82.           #CXDebate, #penpals, and #TECCA
  83.  
  84.      Snail:     Stephen E. Maas (Maasware Enterprises)
  85.                 1271 Cherokee Ave.
  86.                 W. St. Paul, MN
  87.                                 55118-2005
  88.  
  89.      I always enjoy reading questions, comments, concerns, suggestions, corrections, bug reports, flames, and the like. Please send them all off to me. E-mail is preferred as always. You probably won't get a written response if you send stuff snail. You never know though.
  90.  
  91.  
  92. Acknowledgements
  93. ================
  94.  
  95.      There are a select few people, places, and things without which eXpress would never have come to be. Listed in no particular order, they include the following:
  96.  
  97.     * Mike Schoberg -> Cray Research Explorers Post leader
  98.     * Cray Research Park in Eagan Minnesota -> Access to the SPARC
  99.     * Sun Microsystems -> I got the idea while working on a SPARC 4
  100.     * The creators of X-Windows -> Gave me the idea
  101.     * Apple Computer -> The computer and most of the code ;)
  102.     * Mom, Dad, and the rest of the family -> Moral support
  103.     * Phil Kearney III -> Showed me how to write a jGNE filter in C
  104.     * The Internet -> How else would I have met Phil?
  105.     * A few billion electrons -> No explanation necessary
  106.     * Robert Berger -> His USENET post introduced me to SystemMenu()
  107.  
  108.      I thank each and every one of them for the contributions they have made to the creation of eXpress.
  109.  
  110.  
  111. About the Author
  112. ================
  113.  
  114.      eXpress was written by Stephen Maas. He is currently a high school student at Saint Thomas Academy in Saint Paul, Minnesota. Along with Macintosh programming, Stephen can be found buying and selling used computer equipment or hanging out on the local BBS's. He is almost always slaving away at his Classic II 4/120 churning out programs as Elton John's and Michael W. Smith's latest songs throb in the background.
  115.  
  116.      In his "non-computer time", Stephen likes to hang out at the local tennis court, play pinball, kick the soccer ball around, read Agatha Christie novels, watch "The New Twilight Zone" or "ST:TNG", and get ready for the next year's debate season.
  117.  
  118.      Stephen ascribes to the Macintosh programming philosophy of "Make it small and make it fast." He hates large cumbersome programs and loves programming elegance ( he wrote this document with TeachText). Other programs of his, such as Memory (soon to be released), are prime examples of this philosophy.
  119.  
  120.  
  121. Program Specifics
  122. =================
  123.  
  124.      eXpress is a uniquely written piece of software. I hate INIT's so I wrote eXpress as an application that "installs" code like an INIT. 
  125.  
  126.      When launched, eXpress installs a jGNE filter into the System heap and then exits. The jGNE is then called repeatedly as all jGNE's are. When it intercepts a control-mousedown event, the jGNE gets a handle to the System Processes menu and pops this menu up at the location of the control-mousedown event.
  127.  
  128.      When the PopUpMenuSelect() trap returns, the menu item selected is executed by calling SystemMenu() with the respective menu item in the low word. Finally, the original event is set to a nullEvent and life goes on.
  129.  
  130.  
  131.